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PREFACE 


System generation is a tailoring process. Modules are selected from IBM-distributed 
libraries and joined together forming a new system. The user defines the new system 
by means of macro specifications to meet his installation’s machine and data process¬ 
ing needs. The execution of the macros results in modules being selected from the 
distribution libraries and combined into user-allocated data sets on new system vol¬ 
ume^). The system generation process, in its broadest sense, consists of defining 
what an installation’s needs are, ordering distribution libraries from IBM, selecting 
modules from these libraries and placing them by means of macro specification and 
execution in a new system, and testing the new system. 
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The System Generation Process 


This manual describes what the system generation process is. The book is for the 
system programmer who is to generate a new operating system with virtual storage 
(VS) for the first time and for the system planner or manager who needs to know 
the considerations and requirements for generating a new system. The manual 
describes what the system programmer needs to consider in selecting his new system, 
what he must do to select the modules to be in his new system, the requirements in 
generating a new system, and how a new system is generated. The purpose of this 
introduction is to provide background information for the more detailed OS/VS1 
System Generation Reference, GC26-3791, and OS/VS2 System Generation 
Reference, GC26-3792. 

PREREQUISITE PUBLICATIONS: The reader must be familiar with OS/VS systems, 
as described in: 

IBM System/370 Summary, GA22-7001 
OS/VS 1 Planning and Use Guide, GC24-5090 
OS/VS2 Planning and Use Guide, GC28-0600 

REFERENCE PUBLICATIONS: In using this manual, the reader should refer to: 

OS/VS1 Storage Estimates, GC24-5094 
OS/VS2 Storage Estimates, GC28-0604 
OS/VSJCL Reference, GC28-0618 
Operator’s Library: OS/VSI Reference, GC38-0110 
Operator’s Library: OS/VS2 Reference, GC38-0210 
OS,I VS Service Aids, GC28-0633 
OS/VS Utilities, GC35-0005 

OS/VS Message Library: VSI System Codes, GC38-1003 
OS/VS Message Library: VS2 System Codes, GC38-1008 
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This book is divided into three major sections. The order of the information presented 
in each section of the manual indicates the order in which a system generation can be 
performed. 

System Generation Description: System Generation, System Generation Require¬ 
ments, System Control Program Installation, New System Verification, Types of 
System Generation. 

System Generation Process: New System and Program Option Selection, New 
System Macro Specification, Module Selection and Placement in the New System, 

New System Volume Initialization, New System Data Set Initialization, Stage I 
Execution Requirements, Stage II Execution Requirements, Restart Procedures, 
Installation Verification Procedures, Program Product Installation. 

New System Planning Chart: Chart to be used after reading this book for writing 
down what is to be in the new system. 

A glossary is provided at the back of the book. 

Any information pertaining to DSS is for planning purposes only until DSS is 
available. 
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SUMMARY OF MAJOR CHANGES 


The section on new system macro specifications now includes options that can be 
specified for VS1 or VS2 system generation. 
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This section defines system generation. It describes what is needed to perform a 
system generation, how a system is generated, what must be done after a system is 
generated, and the types of generations that can be performed. 

System Generation 


System generation is the process of selecting modules from IBM-distributed libraries 
and tailoring them to create a new VS Operating System (operating system with 
virtual storage) for your installation. 

To meet the needs of many installations, IBM distributes to its customers tape 
libraries that contain all of the modules that it produces in source, object, or load 
module form. Some of these modules are required for every VS Operating System 
and some are optional. Using the distribution libraries and another VS Operating 
System, you specify, through the use of macro instructions, the new VS Operating 
System to be generated. 

Your new system is created when your macros are executed by the system generation 
process. This process relates options you desire to actual supporting code within 
the VS modules. And, it produces the job control language and utility control state¬ 
ments necessary to select the code from the VS distribution libraries and to build 
your new system. During the generation of the new VS Operating System, source 
modules are assembled according to the installation data you provide, object modules 
are linked together, and load modules are copied into the new system. 

There are five major steps in generating a new VS Operating System. These are: 

• Planning 

To plan a new system, you must consider what your installation’s needs are and 
from these needs determine the VS options that will, with the required, stand¬ 
ard VS features, constitute your new system. (See “New System and Program 
Option Selection.”) 

• Stage I 

Stage I is a single assembly of the macro instructions that you code. You select 
and code various macro instructions to specify the options you planned for 
your new system and the standard VS features that are required to be in the 
new system. (See “New System Macro Specification.”) After the macros are 
coded and executed, they are assembled and expanded into job control language 
and utility control statements. 

• Initialization 

Before a new system can be generated, you must initialize direct-access volumes 
to contain the distribution libraries and/or the starter operating system. (See 
“Preparing for a System Generation.”) You must also initialize the direct- 
access volume(s) onto which the new system will be generated and allocate space 
for the data sets on the new system volume(s). (See “New System Volume 
Initialization” and “New System Data Set Initialization.”) 

• Stage II 

Stage II is the execution of the job control language and utility control state¬ 
ments from Stage I. During execution, the job control language and utility 
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control statements assemble, link-edit, and copy specific modules from the 
distribution libraries into the new VS Operating System. (See “System Con¬ 
trol Program Installation.”) 

Testing the New System 

After your new system is generated, you should verify that it is operational. 
(See “Installation Verification Procedures.”) 


System Generation Requirements 

To perform a system generation, you must have IBM-supplied distribution libraries 
containing the VS modules, an existing VS Operating System, or a starter operating 
system from IBM. 


Using an Existing VS Operating System 

If an existing VS Operating System is used, it must contain the IEHDASDR utility 
to initialize direct-access volumes for the distribution libraries and the new system. 
(See "Preparing for a System Generation” and "New System Volume Initialization.”) 
To execute Stage I only, the existing system must contain an assembler. To execute 
Stage II only, it must contain an assembler and a linkage editor, a copy utility 
(IEBCQPY), a catalog and index utility (IEHPROGM), a source language modifica- 

! tion utility (IEBUPDTE), a utility for updating track address (IEHIOSUP) (VS1), 
a utility for reinitializing the data set containing machine error data (1FCDIPOO), and 
a utility (IQADVMOO) for page formatting the DSS load module (VS2) (Dynamic 
Support System, a debugging tool for the Program Systems Representative that 
provides extensive debugging facilities to aid in locating errors and determining the 
system state quickly). 

The assembler for Stage I and the assembler and linkage editor for Stage II must be 
compatible with the VS System Control Program previously generated. 


Ordering the VS Starter Operating System and for the VS Modules 



IBM-Supplied IBM-Supplied 


If you have an existing VS Operating System with the program and machine compo¬ 
nents for generating a new VS Operating System, you need to order only the distri¬ 
bution libraries containing the VS modules. You obtain the distribution libraries 
by sending a tape to IBM. IBM copies the VS modules on the tape and returns it to 
you. If you do not have a VS Operating System, you send two tapes to IBM, one 
for the VS modules and one for a starter operating system. If you do not have any 
tapes or a VS system, you order two tapes from IBM, one containing the VS mod¬ 
ules and the other containing the starter operating system. 


The VS Starter Operating System 
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The starter operating system must be used for the first installation of a VS Operating 
System. For subsequent installations, either the starter operating system or your 
own VS Operating System can be used. 

The starter operating system consists of: 

• A control program that supports the central processing unit(s) and I/O devices 
you need to run the system generation jobs 
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• An assembler for Stage I and Stage II 

• A linkage editor for Stage II 

• The utilities used for data set and volume initialization 

• The utilities for Stage II processing 

Requirements, such as the amount of storage and the devices you need for the 
starter operating system, are detailed in OS/VS1 System Generation Reference 
and OS/VS2 System Generation Reference. Those manuals also contain descrip¬ 
tions of the utilties used before Stage I and during Stage II. 


The VS Modules 



When you send in your own tape to IBM for the modules or order an IBM tape, the 

module(s) are put onto tape as unloaded partitioned data sets with the use of the 

IEBCOPY utility program. These partitioned data sets are called distribution 

libraries. The distribution libraries contain: 

• Program options (VS features that can be included in your new system) 

• Stand-alone utilities that operate in support of or without support of the 
VS System 

• Routines that manipulate collections of data and system control data 

• Routines that manipulate partitioned, sequential, or indexed sequential data 
sets 

• Data management routines 

• Error recovery routines 

• Problem determination routines 

• Job management routines 

• Teleprocessing routines 

• A parameter library (a library that contains a system parameter list used by 
the Nucleus Initialization Program (NIP), a PRESRES list, and a LNKSTOO 
list described in OS/VS1 Planning and Use Guide and OS/VS2 Planning and 
Use Guide) 

• A library of cataloged procedures to perform, for example, a compile/link- 
edit/go 


• A library of macro definitions used during the Stage I assembly 

• A library of macro definitions used during Stage II assemblies 

• A library that contains installation verification procedures for testing the 
new system (see “Installation Verification Procedures”) 

• A system macro library (a library that contains macro definitions for the 
system macros used by the assembler) 
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Within each distribution library are one or more VS modules. Single modules or 
combinations of modules are selected from the distribution libraries and put into 
your new system during Stage II. The selection of modules is determined by the 
program options that you choose. These options are described in “New System 
Macro Specification.” 

Preparing for a System Generation 

Before the generation of a new system, you must: 

o Add any user-written routines to private libraries for inclusion in the new 
system 

o Initialize disk packs for the starter operating system and the distribution 
libraries 

o Restore the starter operating system from tape to a direct-access device of the 
type described in OS/VS1 System Generation Reference and OS/VS2 System 
Generation Reference 

0 Copy the VS distribution libraries from tape to any of the direct-access devices 
described in OS/VS1 System Generation Reference or OS/VS2 System Generation 
Reference 

To add your own routines to the new system, they must be compiled, link-edited 
and placed as members in cataloged partitioned data sets so that they can be 
accessible during Stage II. (See OS/VS1 System Generation Reference or 
OS/VS2 System Generation Reference.) In Stage I, you specify, with various 
macro instructions, the name of the partitioned data set and die name of the 
members containing your routines to be in the new system. 

The starter operating system and the distribution libraries must be on initialized 
disk packs for Stage I and Stage II execution. Initialization is the process of writing 
home addresses, a volume label, and a volume table of contents on a direct-access 
volume. It is also done to check for defective tracks and to assign alternate tracks 
for those that are defective. The IBCDASDI utility or the IEHDASDR utility 
initializes disk packs. 

IBCDASDI must be used to initialize the disk pack for the starter operating system. 
After the pack is initialized, the starter operating system is put on the pack by 
IBCDMPRS (a dump/restore utility program). IBCDASDI and IBCDMPRS are 
on the starter operating system tape. 

The disk packs for the distribution libraries can be initialized by the IEHDASDR 
utility. IEHDASDR is in your starter operating system or in your existing VS 
Operating System. If you are using the starter operating system, you must restore 
it to disk using IBCDMPRS and perform the IPL procedures (see Operator's 
Library: OS/VSJ Reference or Operator’s Library: OS/VS2 Reference for a 
description of the IPL procedures) before IEHDASDR can be used. After the 
packs for the distributuion libraries are initialized, the IEBCOPY utility must be 
used to copy the distribution libraries from tape to disk. 

For a detailed description of the utilities mentioned above, see the OS/VS Utilities 
reference manual. 

The VS distribution libraries may reside on direct-access devices of several different 
types, whereas the starter operating sytem is limited to specific types. The types of 
devices required for the starter operating system and the VS distribution libraries are 
described in OS/VS 1 System Generation Reference and OS/VS2 System Generation 
Reference. 
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System Control Program Installation 

Your new system is generated in two stages. Stage I is a single assembly of macro 
instructions that you code to describe your new system. The output from Stage I is 
a job stream and a diagnostic listing described in die following section. The job 
stream consists of job control language and utility control statements on punched 
cards, as card images on tape or in a data set on disk. Stage II is the execution of the 
job stream produced by Stage I. During this stage, source modules from the distribu¬ 
tion libraries are assembled, object modules from the distribution libraries are link- 
edited, and/or load modules from the distribution libraries are copied into data sets 
that you allocate on the new system vohune(s). (See “New System Data Set Initial¬ 
ization.’’) 


Stage I 
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Input to Stage I consists of job control language statements and macro instructions 
that you code. The macros specify the machine configuration, the control program, 
the data management routines, and your own routines to be included in the new 
system. The macro parameters specify the VS options you want in your new system. 
(See “New System Macro Specification.”) Some of the macros are required and some 
are optional, depending on your needs. These are also described in more detail in 
“New System Macro Specification.” 

| For your macros to be assembled, your Stage I input deck must have an execute state¬ 
ment for the assembler and data definition statements for the Stage I macro definition 
library and for three temporary utility data sets that are required for Stage I. It must 
also have data definition statements describing the output, one for the data set to 
contain the job stream and one for a printer. The sequence of the input deck (cards 
or card images) to Stage I is as follows: 

Job Statement 

Execute Assembler Statement 
Data Definition Statements 
New System Macro Statements 

These are described in OS/VS 1 System Generation Reference and OS/VS2 System 
Generation Reference. 

During execution of your input, the macro instructions are assembled and analyzed 
for valid parameters and dependencies upon other macros. When invalid macro 
specifications are found, Stage I does not produce the job stream for Stage II. And, 
error messages are printed for each invalid macro. If there are no errors, the job 
stream is produced as punched cards or as card images on tape or in a data set on disk 
according to what you specified in your Stage I data definition statement. The Stage 

I I output job stream contains several job statements, each followed by one or more ex¬ 
ecute statements. Each execute statement is followed by its associated data definition 
statements and other control statements required to be used by the assembler, the 
linkage editor, and the utility programs during Stage II. 

The Stage I output job stream should be retained in a tape or direct-access data set in 
order to use the service aid program HMAPTFLE. This program generates the job 
control language necessary for applying a program temporary fix (PTF) from your 
distribution libraries to your new VS system; or it directly applies a PTF object mod¬ 
ule to your new VS system. (Seethe OS/VS Service Aids manual for a description 
of HMAPTFLE and its use.) 
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In addition to the job stream, Stage I also produces a documentation listing. It is a 
printout of the expansion of all the macros that you specify including punch state¬ 
ments that comprise input to Stage II. 


Stage II 


Input (Output 

from Stage 0 



Input to Stage II is the output from Stage I. The processing of the Stage I output in 
Stage II causes multiple executions of the assembler, linkage editor, and system util¬ 
ities. Single modules or combinations of modules are selected from the distribution 
libraries and placed into data sets that you allocate on the new system volume (s). See 
“Selecting the New System Data Sets.” 


Four temporary utility data sets described in OS/VS1 System Generation Reference 
and OS/VS2 System Generation Reference are required for Stage II. Three of them 
are dedicated data sets (preallocated data sets described in OS/VS1 Planning and Use 
Guide and OS/VS2 Planning and Use Guide) in the procedure library. You must 
allocate the fourth data set before executing Stage II. This data set will contain 
object modules when Stage II is executed. During execution, required and selected 
modules are assembled and put into the object module utility data set that you have 
allocated; required and selected executable modules from the distribution libraries 
and object modules from the object module data set are then link-edited into the new 
system data sets; and executable modules from the distribution libraries are copied 
into the new system data sets. 


The output from Stage II is your new VS Operating System. Stage II also produces a 
documentation listing. This is a printout of all the steps executed by the assembler, 
the linkage editor, and the utilities. 


New System Verification 

After your new VS Operating System has been generated, you should verify that the 
new system is operational and that it supports the new system machine configuration. 
(See “Installation Verification Procedures.”) 


Types of System Generation 

There are three types of generation: complete, nucleus only, and I/O device only. 

The type of generation is specified in a macro called GENERATE. This macro pro¬ 
duces the Stage II job stream. For an I/O device only or nucleus only generation, the 
job stream is applied against an existing system that is to be modified. For a complete 
| generation, the Stage II job stream creates an entirely new system. 
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Following are descriptions of the types of system generation that can be performed: 
o Complete 

This is the generation of a complete VS System Control Program. It is done 
when you are installing a new system for the first time or when you must create 
a new control program for an already existing VS Operating System. A com¬ 
plete generation is not required if the desired modifications can be achieved by 
a nucleus or I/O device generation. 

• Nucleus only 

This is the generation of a new nucleus. The options and configuration speci¬ 
fied must be compatible with the rest of the control program. It is done when 
only changes to the nucleus of the control program need to be made. 

• I/O device only 

This is done when I/O devices and channels are to be added, deleted, or modi¬ 
fied. 

The type of generation determines which macro instructions you specify for your 
new system. For each type, some of the machine configuration macros and control 
program macros are required, some are optional, and some do not apply. The data 
management macros may be optional depending on the type of generation you select. 
(See “New System Macro Specification” for a description of some of these macros.) 
The selection of your new system according to the type of system generation is 
described in OS/VS1 System Generation Reference or OS/VS2 System Generation 
Reference . 
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This section provides more detailed information about system generation. It describes 
some of the considerations you should think about when planning a new system, the 
selection and allocation of new system data sets, and some of the macros and how 
they are used to specify the options to be in your new system. It also explains how 
to correct errors that occur during Stage I or Stage II, what is needed for Stage I and 
Stage II execution, and how your new system is tested. 


New System and Program Option Selection 

The first step in generating a new system to satisfy the data-processing needs of your 
installation is to determine exactly what those needs are. 

In analyzing your needs, you should consider such questions as: What is the total 
volume of data-processing work that must be done? What types of work must be 
performed? What are the relative priorities of the different types of work? What 
kind of assistance does each member of the installation need to do his job? What is 
the physical setup of the machines? How many procedures do you want in the pro¬ 
cedure library? If you improve system performance, will the improvement use up 
storage space? Do you plan to extend the capabilities of the control program in the 
future? 

After all your installation’s needs have been considered and you have planned for the 
VS options and standard features described in IBM System/370 System Summary , 
and in either OS/VS1 Planning and Use Guide or OS/VS2 Planning and Use Guide , 
you should be able to select the macros and parameters that define the new system 
machine configuration and new operating system to meet your needs. 


New System Macro Specification 

You code specific macro instructions to describe your new system. The macros 
describe the machine configuration, the control program, the data management rou¬ 
tines, and optionally your own routines. With each macro, you may code one or 
more parameters to specify the program options you have selected to be in your new 
system. Some of the macro instructions are described below to illustrate how they 
are used to specify a new VS Operating System. The selection of the macros to 
describe your new system depends on the type of system generation you are going 
to perform: complete, nucleus, or I/O device (see ‘Types of System Generation”). 
OS/VS1 System Generation Reference and OS/VS2 System Generation Reference 
describe the macros in detail and how to select and code them. 

• Machine configuration 

The central processing unit macro, CENPROCS, specifies the central processing 
unit. The parameters specify the model number and the addition of a second¬ 
ary model. 

The channel macro, CHANNEL, specifies one or more channels. The param¬ 
eters specify the channel address and type. 

The I/O device macro, IODEVICE, specifies the I/O devices you want in your 
new system. The parameters specify their addresses, their types, their features, 
and their programming support. 
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The standard character set image macro, UCS, specifies the character set images 
for a 1403 printer with the universal character set (UCS) feature or for a 3211 
printer. The parameters specify all the images or specific ones and default 
choices. 

The unit name macro, UNITNAME, assigns a generic name to an I/O device or 
a group of I/O devices. The parameters specify the name of the group and the 
I/O device addresses. 

o Control program 

I The control program macro, CTRLPROG, specifies the control program options. 
The parameters specify such options as the number of I/O operations to be pro¬ 
cessed concurrently, the amount of time that a job has control of the central 

I processing unit, a trace-table that stores information to be used for debugging 
and maintenance, and system queue area specifications. 

The scheduler macro instruction, SCHEDULR, specifies the job scheduler and 
master scheduler. The parameters specify requirements and options such as unit 
addresses of the master and alternate consoles; volume mounting procedures; 
the use of a hardcopy log or system log for recording operator commands, 
system commands and responses, and write-to-operator (WTO and WTOR) 
messages; routing codes for the master console; routing codes for write-to- 
operator routines; automatic execution of the commands for starting a reader, 
a writer, or an initiator after IPL; the number of records in a logical track for 
the system job queue; the number of records in the system job queue reserved 
for the termination of jobs; the number of records in the system job queue 
reserved for each initiator started; the use of error volume analysis and the 
residence of volume error statistics records. 

The checkpoint/restart macro, CKPTREST, specifies standard and user-written 
ABEND codes for which an automatic restart can occur. The parameters specify 
whether or not restart can occur for each ABEND code. 

If you want multiple console support in your new system, the secondary console 
macro, SECONSLE, must be specified. Its parameters specify a secondary console, 
an alternate console, routing codes, and valid command codes that can be entered 
into a specified console. 

The macro library macro, MACLIB, specifies certain macros to be excluded 
from the macro library in the new system. The parameters specify which 
macros are to be excluded. 

The editor macro, EDITOR, specifies linkage editor options. The parameters 
specify size of virtual storage for the linkage editor and its buffer. 
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The loader macro instruction, LOADER, specifies the options to be included 
in the loader processing program. Its parameters specify the input data set 
that contains the loader program input, the library to be searched to resolve 
external references, the data set for the external reference map and diagnostic 
messages, and the amount of virtual storage required for the loader program 
buffers, tables, and problem program. 

Data management routines 

The data management macro, DATAMGT, specifies optional access methods 
to be included in your new system. The parameters specify the methods. 

The graphics macro, GRAPHICS, specifies graphic programming services. The 
parameters specify the inclusion of problem-oriented routines and the graphic 
subroutines. 

User-written routines 

The link library macro, LINKLIB, specifies the inclusion of your own routines, 
in load module form, in the link library of your new system. The parameters 
specify the partitioned data set that contains your load modules and the 
members that are to be added. 

The resident module macro, RESMODS, specifies the inclusion of your own 
routines, in object or load module form, in the system nucleus library. The 
parameters specify the partitioned data set that contains your modules and 
the members to be added to the system nucleus library. 

Other user-written routines, such as SVC routines and I/O appendages, can also 
be included in the new system during system generation. 

The SVC table macro, SVCTABLE, specifies entries to be in the SVC table. 
These entries are defined by the macro parameters. The parameters specify 
the number and type of the SVC routines, written by you, that are to be added 
to the new system. 

New system data set allocation and cataloging 

The data set macro, DATASET, can be used to allocate space to the required 
and optional system data sets on the new system volume(s) and to catalog the 
data sets in the system catalog during system generation. The macro parameters 
specify the system data set to be allocated, the new system volume on which it 
will reside, and the amount of space to be allocated on the volume. Default 
values are used for the DCB information that is required for the data sets so 
this information is not specified. (System data sets can also have space allocated 
to them and they can be cataloged before system generation by using the 
IEHPROGM utility program. Refer to “New System Data Set Initialization” for 
this information.) 

Generation 

The last macro to code, GENERATE, analyzes compatibilities between the 
various macros specified. If no errors are found, it produces the job control 
language and utility control statements for Stage 11. Its parameters specify 
the volume name and device type for the new system. 
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When you code the macros, there are many things to be considered. One of these is 
dependency of one macro upon another as described in OS/VS1 System Generation 
Reference and OS/VS2 System Generation Reference. Another very important con¬ 
sideration is the storage needed for the specified options as described in OS/VS1 
Storage Estimates and OS/VS2 Storage Estimates. 

Module Selection and Placement in the New System 

Specific modules from the distribution libraries are joined together during Stage II to 
provide the programming support for the new operating system as specified in Stage I. 
Modules are retrieved from die distribution libraries, assembled, link-edited or copied 
into the new system data sets according to the macro expansion produced by Stage I. 
The macro expansion, consisting of job control language and utility control state¬ 
ments, specifies the new system data sets into which the modules from the distribu¬ 
tion libraries will be placed as shown in the illustration that follows. 

Because you know which program options you want in the new system, you must 
allocate on the new system volume the data sets that will contain your program 
options before Stage II is executed. At this time, you must also allocate new system 
data sets to contain the modules that will make up the required, standard VS features. 
“New System Data Set Initialization” describes the selection and allocation of sys¬ 
tem data sets. 

New System Volume Initialization 

Before Stage II is executed, you must either mount the direct-access volumes contain¬ 
ing the existing system to be modified for an I/O device or nucleus only generation 
or initialize direct-access volumes for a complete generation as described below. 

If a complete system is being generated, the direct-access volume(s) for the new sys¬ 
tem must be checked for defective tracks and home addresses, and a volume label 
and volume table of contents must be written on the new system volume(s). This 
can be done by using either the IBCDASDI utility or the IEHDASDR utility. 

The IBCDASDI utility is on the first file of the starter operating system tape; 
it is a stand-alone or independent utility, which means that it can be executed in¬ 
dependently of an operating system. IBCDASDI can be used to initialize the volume 
that is to contain the starter operating system. 

The IEHDASDR utility is in the starter operating system or in your existing system 
(if this is not your first system generation). IEHDASDR is a system utility, which 
means that it can only be executed under the control of an operating system. If 
you are using the starter operating system, you must restore it to disk and perform 
the IPL procedures before IEHDASDR can be used. 

The initial program loader (IPL) program must be written on the new system volume 
The IPL program is in the distribution libraries. You can use IEHDASDR from the 
starter operating system or IBCDASDI to write the IPL program on the new system 
volume. It is written on the volume by punching out the IPL program from the dis¬ 
tribution libraries and inserting the cards with the IBCDASDI or IEHDASDR input 
deck. Or, you can retrieve the program directly from the starter operating system 
using IEHDASDR. OS/VS1 System Generation Reference and OS/VS2 System Gen¬ 
eration Reference describe the procedures for punching the IPL program into cards. 
The OS/VS Utilities reference manual describes the use of IBCDASDI or IEHDASDR 
for writing the IPL program on the new system volume and for initializing the disk 
packs. 
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New System Data Set Initialization 

New system data sets must be initialized before Stage II is executed. Initialization is 
the process of: 

• Allocating space for system data sets on the new system volume 

• Building the volume index of the system catalog 

• Cataloging the data sets in the new system catalog 

You can ini tializ e the new system data sets by specifying the data set macro in 
Stage I. The data set macro, when executed, creates the job control language to 
allocate and catalog the data sets specified by its parameters. You can also initialize 
the new system data sets by executing your own job control language deck before 
Stage II is executed. If you provide your own deck, it should consist of: 

• A job statement 

• An execute statement for IEHPROGM (a utility that catalogs the data sets on 
the new system volume) 

• A data definition statement for the message output data set 

• Data definition statements for each new system data set and the system catalog 
data set 

• A catalog control statement for each data set to be cataloged 

Selecting the New System Data Sets 

Some of the new system data sets are required in your new system and some are 
optional. The required data sets are basic to your new VS Operating System. These 
data sets are needed to contain load modules such as those that constitute catalog 
or installation verification procedures; nonresident Supervisor Call (SVC) routines; 
nonresident error handling or nonresident machine-check handler routines; access 
method routines; processors; macro definitions for system macro instructions; 

PRES RES, LINKSTOO lists and a system parameter list used by the Nucleus Initial¬ 
ization program (NIP) (the types of lists are described in OS/VS1 Planning and Use 
Guide and OS/VS2 Planning and Use Guide); and statistical data about machine 
errors. A system catalog data set and a data set that the scheduler uses as a work 
area are also required data sets. 

The optional data sets are those that contain certain program options. These become 
required when you have selected a particular program option to be in your new 
system. For example, if you select a teleprocessing access method, which is not 
required for every new system, you must allocate the telecommunications library 
on the new system volume. The telecommunications library is the only data set 
into which teleprocessing access methods can be put. 

The complete group of required and optional new system data sets is described in 
OS/VS 1 System Generation Reference and OS/VS2 System Generation Reference. 
They give each new system data set name, whether it is required or optional, its 
data definition statements, whether it should be cataloged or not, its type (sequen¬ 
tial or partitioned), and its contents after the new system has been generated. 
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Allocating the New System DataSets 

The number of load modules put into a data set, according to the option you specify, 
defines die storage space that the data set will occupy. OS/VS1 Storage Estimates 
and OS/VS2 Stonge Estimates explain how to calculate the amount of storage needed 
for the various program options. 


When you have estimated the size of the new system data sets, you will have to 
decide if you want them on one volume or multiple volumes. They may have to be 
on multiple volumes because of their size or you may want them on multiple volumes 
for better system performance. (See OS/VS1 Planning and Use Guide or OS/VS2 
Planning and Use Guide for performance considerations.) 

The new system data sets can be arranged on the new system volume(s) in different 
ways. The primary system residence volume contains the IPL program. It must also 
contain some of the required data sets described previously. If it is the only volume, 
it will have all the required data sets and those data sets needed for the program 
options you choose. When the new system is on one volume, frequently-used and 
closely-related data sets should be placed adjacent to one another. For best system 
performance, frequently-used data sets should be on a volume other than the primary 
system residence volume. 


Stage I Execution Requirements 


Existing 

User 

VS 

Operating 

System 

9 

-1- 

Or 

—L- - 

VS Starter 
Operating 
System 




VS 

Distribution 

Libraries 


Your macro instructions are executed as one assembler job, which uses an existing 
VS Operating System or starter operating system described in “System Generation 
Requirements.’* In order for your macros to be executed, the volume containing the 
Stage I macro definition library and the volume containing the temporary utility data 
sets you defined for Stage I must be accessible during this stage. These utility data 
sets may be on any volume that has sufficient space for them. 


Stage II Execution Requirements 



Existing 
User VS 
Operating 
System 


VS 

Distribution 

Libraries 


Or 

_L 


VS Starter 
Operating 
System 



New VS 


Operating 

System 


The job control language and control statements from Stage I are executed as multiple 
jobs of assemblies, link-edits, and copies. Execution is done by an existing VS Oper¬ 
ating System or starter operating system described in “System Generation Require¬ 
ments.” For Stage II, the volume(s) containing the Stage II macro definition library, 
all the distribution libraries, the dedicated utility data sets (preallocated data sets 
described in OS/VSJ Planning and Use Guide and OS/VS2 Planning and Use 
Guide), the object module data set you defined for Stage 11, and the new system 
volume(s) must be accessible during this stage. 
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Restart Procedures 


During execution of Stage I or Stage II, errors may occur requiring you to restart one 
or both of these stages. These errors and the procedures for restarting each stage are 
described below. 


Stage I 


The most common errors during Stage I are: 

• Keypunching errors 

• Contradictory or invalid specifications in the macro instructions 


Keypunching errors are indicated by system generation error messages or assembler 
error messages. Invalid specifications are indicated by system generation error mes¬ 
sages. If the system finds any errors, the job stream for Stage II is not produced. 

When errors are found, the input deck described in “Stage I” must be corrected and 
the entire assembler job of your input deck must be reexecuted. 


Stage II 


The most common errors caused during Stage II are: 

• Machine interruptions and noncontinuous machine time 

• Faulty new system data set allocation 

• Errors in the Stage I input deck that could not be detected during Stage I, 
such as allocation of the nucleus data set on a different residence volume than 
the one specified in the GENERATE macro instruction 

• Procedural errors, such as invalid volume mounting 

The input deck to be corrected for Stage II consists of several jobs each having 
several steps. Any step in the job stream can be reexecuted if all previous steps in 
that job have been properly executed. 

Once a job or job step has been corrected, it is reexecuted in one of several ways. 

A single job that has only one step is reexecuted from the beginning of the step and 
a multiple-step job is reexecuted by your placing the job card in front of the step to 
be reexecuted. Other jobs, such as copying modules into a new system data set, may 
require that the data set be moved or copied to another volume in order to allocate 
more space on the new system volume if the data set was not large enough for the 
modules. 

If any statements in the job stream are to be changed, the easiest way to change 
them is to have the job stream in cards. If the job stream is on tape, the IEBPITCH 
utility can be used to punch the job stream into cards. You can change statements 
on tape by using either the IEBUPDTE data set utility or the IEBGENER data set 
utility. (See the OS/VS Utilities reference manual for a description of how to use 
these utilities.) 


20 OS/VS System Generation Introduction 



Some of the errors during Stage II may not change any of the job stream statements. 
An example is the one mentioned previously. A data set used in a job step has to be 
reallocated, because it was too small for that step. In this event, another data set 
utility, IEBEDIT, can be used. IEBEDIT creates a new job stream onto another tape. 
This new job stream consists of jobs you want to restart They can be: 

• A job step and all the steps that follow'|it, or 

• Specific job steps within a job, or 

• All the job steps in the job 

OS I VS 1 System Generation Reference and OS/VS2 System Generation Reference 
describe the coding methods and use of the utilities needed to reexecute Stage I 
or Stage II. The OS/VS Utilities manual describes the utilities. 


Installation Verification Procedures 



Your new OS/VS Operating System must be tested to eliminate any possible mal¬ 
functions. You can test your new system by using a process called the Installation 
Verification Procedures (IVP). 

The Installation Verification Procedures are in one of the distribution libraries. It 
contains jobs that run with all machine configurations. These jobs print out the 
procedure library, test the basic new system functions generated by executing an 
assemble/link-edit/go, force an 806 ABEND (see OSfVS Message Library: 

VS1 System Codes or OS/VS Message Library: VS2 System Codes), and issue a 
UNIT status command for I/O device addresses, type, status, volume serial number 
and state, ordered output, and device bypass. The job stream is used to test only the 
VS Operating System’s System Control Program (SCP) that is generated and its sub¬ 
sequent updates. Program Products, programs with service classification “C,” and 
similar programs to be added after a new system has been generated should be tested 
by their own Installation Verification Procedure or sample program. 


Program Product Installation 

The new operating system that is generated is a System Control Program. Program 
Products are neither distributed nor generated with the System Control Program. 
Manuals describing specific program products contain the procedures and require¬ 
ments for installing them. 
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NEW SYSTEM PLANNING CHART 


This chart is intended as an aid for considering the options to be in your new system. 

LIST IN EACH SECTION BELOW THE FEATURES TO B E IN THE NEW SYSTEM. 

DISK--- 

RESIDENT VOLUME IDENTIFICATION -_ 

LIBRARY VOLUME IDENTIFICATION - _ 

CPU MODEL -_REAL STORAGE SIZE 

CONTROL PROGRAM 


DATA MANAGEMENT 


JOB SCHEDULER 

TYPE -- DESIGN -_ 


(6-character maximum) 
(6-character maximum) 
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TASK SUPERVISOR RESIDENT FUNCTIONS 


USER-WRITTEN ROUTINES 


IF ANY SPECIAL I/O DEVICES MUST BE INCLUDED. LIST THEM HERE. ALSO LIST ANY OTHER NEEDS SUCH AS 
USER SVCs. 
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GLOSSARY 


The following terms are defined as they are used in this book. If you do not find the term you are looking for, refer 
to the'index or to the IBM Data Processing Glossary, GC20-1699. 


control pro gra m : A program that is designed to schedule 
and supervise the performance of data processing work 
by a computing system. 

complete generation: The creation of an entirely new 
VS Operating System’s System Control Program or the 
modification of the existing VS Operating System’s 
System Control Program. 

d e dicated data sets: Preallocated data sets belonging 
to the initiator that are used only temporarily durag 
a job step. 

distribution libraries: IBM-supplied partitioned data 
sets on tape containing single VS modules or combina¬ 
tions of VS modules that the user restores to disk for 
subsequent inclusion in a new system. 

dynamic support system (DSS): An interactive 
debugging facility that allows authorized maintenance 
personnel to monitor and analyze events and alter 
data. 

existing operating system: A system the user has that 
is used to process Stage I and Stage II. It is also a sys¬ 
tem that tiie user has and wants to change to include 
new or more I/O devices, more program options, or 
updates to data management and user-written routines. 

initialization: The use of the IBCDASDI or the 
IEHDASDR utility for writing a home address, a volume 
label, and a volume table of contents on a direct-access 
volume, for checking for defective tracks and assigning 
alternate tracks for those that are defective, and for 
writing the IPL program on the new system volume. 

"initial program loader (IPL): The procedure that 
causes the initial part of an operating system or other 
program to be loaded such that the program can then 
proceed under its own control. 

installation verification procedures: Jobs within a par¬ 
titioned data set in the distribution libraries that test if 
the new operating system is working correctly. 

* American National Standard Definition 


I/O device generation: The generation of a new system 
to add, delete, or modify I/O devices and channels. It is 
done when only changes to the I/O devices have to be 
made. 

load module: A module that is the output of a linkage 
editor. Or, a program in a format suitable for loading 
into virtual storage for execution. 

"module: A program unit that is discrete and identifiable 
with respect to compiling, combining with other units 
and loading, for example, the input to, or output from, 
an assembler, compiler, linkage editor, or executive rou¬ 
tine. 

new system: An entirely new VS Operating System that 
has been generated. Or, an existing VS Operating System 
that is changed to include support for new or more I/O 
devices, more program options, or updates to data man¬ 
agement and user-written routines. 

new system data sets: User-allocated data sets on the new 
system volume into which load modules and executable 
modules from the distribution libraries are link-edited or 
copied in Stage II. 

new system data set initialization: The process of allocat¬ 
ing space for data sets on the new system volume, building 
the volume index of the system catalog, and cataloging 
the data sets in the new system catalog. 

new system volume: The volume that contains user- 
allocated data sets into which modules or combinations 
of modules are placed during Stage II. 

nucleus generation: The creation of a new nucleus only. 

"object module: A module that is the output of an 
assembler or compiler and is input to a linkage editor. 

’"operating system: Software which controls the execu¬ 
tion of computer programs and which may provide 
scheduling, debugging, input/output control, accounting, 
compilation, storage assignment, data management, and 
related services. 
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page: A fixed-length block of instructions and/or data. 

pageable supervisor area: Virtual storage where super¬ 
visor routines are loaded only when required for execu¬ 
tion. 

parameter library: A library that contains a system 
parameter list used by the Nucleus Initialization Pro¬ 
gram (NIP), a PRES RES list, a LINKSTOQ list, and 
other lists described in OS/VS1 Planning and Use Guide 
and OS/VS2 Planning and Use Guide. 

primary system residence volume: The new system 
volume that contains the initial program loader (IPL) 
program, the nucleus of the operating system, the 
highest level index of the catalog, and the SVC library. 

program options: Features of the VS Operating Sys¬ 
tem that the user may indude in his system by coding 
specific macro parameters. 

real storage: The storage of System/370, from 
which the central processing unit can directly 
obtain instructions and data, and to which it 
can directly return results. 

source module: The source statements that constitute 
the input to a language translator for a particular trans¬ 
lation. 

stage I: A single assembly of user-coded macros with 
output consisting of job control language statements 
and utility control statements for Stage II assemblies, 
link-edits, and copies. 

stage II: The execution of job control language state¬ 
ments and utility control statements from Stage I to 
assemble, link-edit, and copy selected modules, speci¬ 
fied by the Stage I macros, into the new system. 


starter operating system: An IBM-supplied VS Oper¬ 
ating System consisting of a control program that sup¬ 
ports any of the central processing units needed to gen¬ 
erate a new system, a minimum machine configuration, 
an assembler and linkage editor for Stage I and Stage II, 
and utilities for new system data set and volume initial¬ 
ization. It is used when there is not an existing VS 
Operating System with which to generate a new system. 

♦system: An organized collection of men, machines, 
and methods required to accomplish a set of specific 
functions. 

system macro library: A library that contains macro def¬ 
initions for the system macros used by the assembler. 


system generation: The process of obtaining VS modules 
on tape, ordering a starter operating system if there is no 
VS Operating System, specifying macros to include VS 
features and options in the new system, including the VS 
features and options by macro execution, executing the 
macro expansion to generate the new system, and testing 
the new system. 

♦system residence volume: The volume on which the 
nucleus of the operating system and the highest-level index 
of the catalog are located. 


virtual storage: Addressable space that appears to the 
user as real storage, from which instructions and data 
are mapped into real storage locations. The size of 
virtual storage is limited by the addresting scheme of 
the computing system and by the amount of auxiliary 
storage available, rather than by the actual number of 
real storage locations. 


"American National Standard Definition. IBM is grateful to the American National Standards Institute (ANSI) for permission to 
reprint its definitions from the American National Standard Vocabulary for Information Processing (Copyright © 1970 by 
American National Standards Institue, Incorporated), which was prepared by Subcommittee X3.S on Terminology and 
Glossary of American National Standards Committee X3. 
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INDEX 


Indexes for reference manuals are consolidated in OS/VS Master Index, GC28-0602. For additional 
information about any subject listed below, refer to other publications listed for the same subject 
in the Master Index. 
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